/*
 * Copyright (c) 2007-2020 西安交通信息投资营运有限公司 版权所有
 */

package com.xci.edu.core.dao;

import com.github.lvyanyang.annotation.Paging;
import com.xci.edu.core.entity.EduCategory;
import com.xci.edu.core.filter.EduCategoryFilter;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 培训科目信息数据层
 * @author 张谦 zhangqian@xci96716.com
 * @since 2020-11-24 17:54:07
 */
public interface EduCategoryDao {
    /**
     * 新建培训科目信息
     * @param entity 培训科目信息实体
     * @return 返回影响的行数
     */
    int insert(@Param("entity") EduCategory entity);

    /**
     * 修改培训科目信息
     * @param entity 培训科目信息实体
     * @return 返回影响的行数
     */
    int update(@Param("entity") EduCategory entity);

    /**
     * 根据主键修改培训科目信息状态
     * @param id     培训科目主键
     * @param status 培训科目状态
     * @return 返回影响的行数
     */
    int updateStatus(@Param("id") Long id, @Param("status") Boolean status);

    /**
     * 根据主键删除培训科目信息
     * @param id 培训科目信息主键
     * @return 返回影响的行数
     */
    int deleteById(@Param("id") Long id);


    ///**
    // * 根据主键删除培训科目信息
    // * @param id 培训科目信息主键
    // * @param deleteId 删除标识
    // * @return 返回影响的行数
    // */
    //int deleteById(@Param("id") Long id, @Param("deleteId") Long deleteId});

    ///**
    // * 是否存在指定主键的培训科目信息
    // * @param id 培训科目信息主键
    // * @return 如果存在返回true
    // */
    //boolean existxById(@Param("id") Long id);

    /**
     * 是否存在指定名称的培训科目信息
     * @param name 培训科目信息名称
     * @param id 排除的主键，如果为null则不指定排除的主键
     * @return 如果存在返回true
     */
    boolean existxByName(@Param("name") String name, @Param("id") Long id);


    /**
     * 根据主键查询单个培训科目信息
     * @param id 培训科目信息主键
     * @return 返回培训科目信息实体
     */
    EduCategory selectById(@Param("id") Long id);

    /**
     * 查询培训科目信息列表
     * @param filter 过滤条件
     * @return 返回培训科目信息列表
     */
    List<EduCategory> selectList(@Param("filter") EduCategoryFilter filter);

    /**
     * 查询培训科目信息分页列表
     * @param filter 过滤条件
     * @return 返回培训科目信息分页列表
     */
    /*
        allowSortNames = {"name","total_period","day_max_period","validate_try_time","validate_timeout","validate_random_range","remark"},
        sortNameMaps = {"name:name","total_period:total_period","day_max_period:day_max_period","validate_try_time:validate_try_time","validate_timeout:validate_timeout","validate_random_range:validate_random_range","remark:remark"}
    */
    @Paging
    List<EduCategory> selectPageList(@Param("filter") EduCategoryFilter filter);


    /**
     * 查询培训科目信息(下拉框)
     *
     * @return 培训科目信息(下拉框)
     */
    List<EduCategory> getCategoryIdAndCategoryName();
}